<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
		<TITLE>User's Reference - Export</TITLE>
		<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
	<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF" link="#00004b" vlink="#4b004b">
		<TABLE width=510 border=0 cellpadding=0 cellspacing=0>
			<TR>
				<TD><IMG src="../images/spacer.gif" width=80 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=49 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=24 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=100 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=3 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=127 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=6 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=50 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=71 height=1></TD>
			</TR>
			<TR>
				<TD colspan=9><IMG src="../images/flcgh_01.gif" width=510 height=24 alt="OpenDX - Documentation"></TD>
			</TR>
			<TR>
				<TD colspan=2><A href="../allguide.htm"><IMG src="../images/flcgh_02.gif" width=129 height=25 border="0" alt="Full Contents"></A></TD>
				<TD colspan=3><A href="../qikguide.htm"><IMG src="../images/flcgh_03.gif" width=127 height=25 border="0" alt="QuickStart Guide"></A></TD>
				<TD><A href="../usrguide.htm"><IMG src="../images/flcgh_04.gif" width=127 height=25 border="0" alt="User's Guide"></A></TD>
				<TD colspan=3><B><A href="../refguide.htm"><IMG src="../images/flcgh_05d.gif" width=127 height=25 border="0" alt="User's Reference"></A></B></TD>
			</TR>
			<TR>
				<TD><A href="refgu055.htm"><IMG src="../images/flcgh_06.gif" width=80 height=17 border="0" alt="Previous Page"></A></TD>
				<TD colspan=2><A href="refgu057.htm"><IMG src="../images/flcgh_07.gif" width=73 height=17 border="0" alt="Next Page"></A></TD>
				<TD><A href="../refguide.htm"><IMG src="../images/flcgh_08.gif" width=100 height=17 border="0" alt="Table of Contents"></A></TD>
				<TD colspan=3><A href="refgu009.htm"><IMG src="../images/flcgh_09.gif" width=136 height=17 border="0" alt="Partial Table of Contents"></A></TD>
				<TD><A href="refgu175.htm"><IMG src="../images/flcgh_10.gif" width=50 height=17 border="0" alt="Index"></A></TD>
				<TD><A href="../srchindx.htm"><IMG src="../images/flcgh_11.gif" width=71 height=17 border="0" alt="Search"></A></TD>
			</TR>
		</TABLE>
		<H3><A name="HDREXPORT" ></A>Export</H3>
		<A NAME="IDX484"></A><A NAME="IDX485"></A>
<P><STRONG>Category</STRONG>
<P>
<A HREF="refgu008.htm#HDRCATIAE">Import and Export</A>
<P><STRONG>Function</STRONG>
<P>
Writes an external data file.
<P><STRONG>Syntax</STRONG>
<PRE>
Export(<STRONG>object, name, format</STRONG>);
</PRE>
<P><STRONG>Inputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Default
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>object</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">object
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">none
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">object to write
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>name</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">string
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">none
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">file name to write to
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>format</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">string
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">&quot;dx&quot;
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">format in which to write the file
</TD></TR></TABLE>
<P><STRONG>Functional Details</STRONG>
<P>
The Export module writes <TT><STRONG>object</STRONG></TT> to the file
<TT><STRONG>name</STRONG></TT> in the specified
<TT><STRONG>format</STRONG></TT>.
<P>
You can specify <TT><STRONG>format</STRONG></TT> as <TT>dx</TT>,
<TT>array</TT>,

or <TT>vrml</TT>.

<P>
If <TT><STRONG>format</STRONG></TT> = <TT>dx</TT>, this specification
can be followed by one or more of the following modifiers:
<TABLE CELLPADDING="3">
<TR VALIGN="TOP"><TD><P><I>byteorder
</I></TD><TD><P>Can be "msb" or "lsb" for most significant byte first or
least significant byte first, respectively.
</TD></TR><TR VALIGN="TOP"><TD><P><I>dxformat
</I></TD><TD><P>Can be "ieee," or "text" for IEEE
floating point or ASCII format, respectively.
You can also specify "ascii" as a synonym for
"text", and "binary" as a synonym for
"ieee".
</TD></TR><TR VALIGN="TOP"><TD><P><I><VAR>where</VAR>
</I></TD><TD><P>Can be one of the following three keywords:
<TABLE CELLPADDING="3">
<TR VALIGN="TOP"><TD><P>"follows"
</TD><TD><P>The data for each object follows the header for that object.
</TD></TR><TR VALIGN="TOP"><TD><P>"1"
</TD><TD><P>The data for each object is contained in a separate data section in
the file.
</TD></TR><TR VALIGN="TOP"><TD><P>"2"
</TD><TD><P>The data for each object is contained in a separate file.
</TD></TR></TABLE>
For "follows" and "1," the module writes a single file with
the file name (<I>name</I><TT>.dx</TT>).
For "2," the module writes files.
The object headers are written to <I>name</I><TT>.dx</TT>; the
data are written to <I>name</I><TT>.bin</TT> (binary data)
or <I>name</I><TT>.data</TT>
(text data).
For more information,
see <A HREF="usrgu067.htm#HDRIMD">Appendix B. "Importing Data: File Formats"</A>
in <I>IBM Visualization Data Explorer User&#39;s Guide</I>.
</TD></TR></TABLE>
<P>
If <TT><STRONG>format</STRONG></TT> = <TT>"array,"</TT> this
specification can be followed by one or both of the following modifiers:
<P>
<TABLE CELLPADDING="3">
<TR VALIGN="TOP"><TD><P><VAR>quotes</VAR>
</TD><TD><P>Puts quotation marks around string data.
</TD></TR><TR VALIGN="TOP"><TD><P><VAR>headers</VAR>
</TD><TD><P>Puts a header of descriptive information at the top of the file.
</TD></TR></TABLE>
<P>
The data are written out in ASCII spreadsheet format (in columns).
Only position-dependent data are supported.
All position-dependent data are written to the output file.
The first column will contain the positions themselves.
<P>
If <TT><STRONG>object</STRONG></TT> contains a group of fields, these are
written out one after the other.
<P>

If <TT><STRONG>format</STRONG></TT> = "vrml", or the extension of the
filename is .wrl, then a VRML 2.0 format file will be written.
Because VRML files are written out in ASCII they can be very large, so
you should reduce the number of polygons before exporting if possible,
for example by using SimplifySurface.
The object exported must be a field or group with two- or
three-dimensional positions. Data Explorer objects are exported using VRML
geometry nodes IndexFaceSet, IndexLineSet, PointSet, or ElevationGrid
depending on the connections element type and regularity of positions.
Colors and normals are exported with each object, if they exist.

<P><STRONG>Example Visual Program</STRONG>
<PRE>
UsingSwitchAndRoute.net

SimplifySurface.net

</PRE>
<P><STRONG>See Also</STRONG>
<P>
&nbsp;<A HREF="refgu073.htm#HDRIMPORT">Import</A>,
&nbsp;<A HREF="refgu142.htm#HDRSIMPSUR">SimplifySurface</A>
		<P>
		<HR>
		<DIV align="center">
			<P><A href="../allguide.htm"><IMG src="../images/foot-fc.gif" width="94" height="18" border="0" alt="Full Contents"></A> <A href="../qikguide.htm"><IMG src="../images/foot-qs.gif" width="94" height="18" border="0" alt="QuickStart Guide"></A> <A href="../usrguide.htm"><IMG src="../images/foot-ug.gif" width="94" height="18" border="0" alt="User's Guide"></A> <A href="../refguide.htm"><IMG src="../images/foot-ur.gif" width="94" height="18" border="0" alt="User's Reference"></A></P>
		</DIV>
		<DIV align="center">
			<P><FONT size="-1">[ <A href="http://www.research.ibm.com/dx">OpenDX Home at IBM</A>&nbsp;|&nbsp;<A href="http://www.opendx.org/">OpenDX.org</A>&nbsp;] </FONT></P>
			<P></P>
		</DIV>
		<P></P>
	</BODY></HTML>
